home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / mssize.z / mssize
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmssssssssiiiizzzzeeee((((3333GGGG))))                                                          mmmmssssssssiiiizzzzeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmssssssssiiiizzzzeeee - specifies multisample buffer configuration
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee mmmmssssssssiiiizzzzeeee((((ssssaaaammmmpppplllleeeessss,,,, zzzzssssiiiizzzzeeee,,,, ssssssssiiiizzzzeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssaaaammmmpppplllleeeessss
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 zzzzssssiiiizzzzeeee
  15.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssssssiiiizzzzeeee
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _s_a_m_p_l_e_s   is the number of samples to be stored at each framebuffer pixel
  19.                location. The default is zero.
  20.  
  21.      _z_s_i_z_e     is the number of bits per depth component desired in the
  22.                multisample buffer.
  23.  
  24.      _s_s_i_z_e     is the number of bits per stencil field desired in the
  25.                multisample buffer.
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      By default the normal framebuffer is configured to store one sample at
  29.      each pixel location.  This sample can include one, two, or four color
  30.      buffers, a single depth value, and a stencil value.  mmmmssssssssiiiizzzzeeee allows
  31.      configuration of the normal framebuffer to store many samples at each
  32.      pixel location.  Because the samples specified by mmmmssssssssiiiizzzzeeee are distinct
  33.      from the single sample that is normally stored, the default mssize of
  34.      zero corresponds to the default single-sample configuration.
  35.  
  36.      mmmmssssssssiiiizzzzeeee takes effect when gconfig is called.  The requested sample count
  37.      and multisample buffer sizes are considered along with the other gconfig
  38.      requests, such as double buffering and RGB mode.  Multisample red, green,
  39.      blue, and alpha component sizes are made identical to those in the normal
  40.      framebuffer.
  41.  
  42.      For example, consider the following request:
  43.  
  44.           RGBmod();
  45.           double();
  46.           mssize(4,32,1);
  47.           zbsize(0);
  48.           stensi(0);
  49.           gconfi();
  50.  
  51.  
  52.      If this request is honored, the framebuffer will be configured with 2 RGB
  53.      color buffers (front and back) and 4 separate samples each consisting of
  54.      a single RGB color, a 32-bit depth value, and a 1-bit stencil value.
  55.      Note that no depth or stencil bits are directly associated with the front
  56.      and back color buffers, because none were requested.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmssssssssiiiizzzzeeee((((3333GGGG))))                                                          mmmmssssssssiiiizzzzeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Likewise, the request:
  75.  
  76.           RGBmod();
  77.           double();
  78.           mssize(4,32,1);
  79.           zbsize(32);
  80.           stensi(1);
  81.           gconfi();
  82.  
  83.  
  84.      if granted, results in the same multisample configuration, but includes a
  85.      regular zbuffer and a stencil buffer.
  86.  
  87.      The _s_a_m_p_l_e_s, _z_s_i_z_e and _s_s_i_z_e granted may not be exactly what was
  88.      requested.  After a call to mmmmssssssssiiiizzzzeeee and ggggccccoooonnnnffffiiii call ggggeeeettttggggccccoooo to determine
  89.      how the framebuffer was actually configured.
  90.  
  91.      Just as the default single sample at each framebuffer pixel is considered
  92.      to be located at the center of that pixel, the _s_a_m_p_l_e_s multisamples each
  93.      have a fixed location near the corresponding pixel center.  These
  94.      locations are chosen by the GL to provide good area sampling.
  95.  
  96. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.      gconfi, getgco, msalph, msmask, mspatt, mssize, multis, RGBsiz, stensi,
  98.      zbsize
  99.  
  100. NNNNOOOOTTTTEEEESSSS
  101.      This routine is available only in immediate mode.
  102.  
  103.      IRIS-4D G, GT, GTX, VGX, and VGXT models, the Personal Iris, Indigo
  104.      Entry, Indy, XL, XS, XS24, XZ, Elan and Extreme systems do not support
  105.      mmmmssssssssiiiizzzzeeee.
  106.  
  107.      Although separate specifications are allowed for normal and multisample
  108.      z-buffer sizes, and for normal and multisample stencil buffer sizes,
  109.      implementations need not support differing non-zero buffer sizes.
  110.  
  111.      The IRIS-4D RealityEngine models support at least the following values
  112.      for _s_a_m_p_l_e_s:  0, 4, 8, 16 with a _z_s_i_z_e of 0, 24 or 32 and with an _s_s_i_z_e
  113.      of 0 through 8.
  114.  
  115. BBBBUUUUGGGGSSSS
  116.      On the IRIS-4D RealityEngine models the framebuffer cannot be configured
  117.      to consist of 32 Z buffer planes, or 32 depth planes in the multisample
  118.      buffer, and 8 color planes for each of the RGB color buffers
  119.      simultaneously.
  120.  
  121.      On the IRIS-4D RealityEngine models the framebuffer cannot be configured
  122.      to consist of more than 1 stencil plane in the multisample buffer, and 8
  123.      color planes for each of the RGB color buffers simultaneously.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.